home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 008a / files008.zip / FILES.DOC < prev    next >
Text File  |  1991-10-02  |  5KB  |  129 lines
  1.  
  2.  
  3.  
  4.            Files v0.08, display open files table under Desqview
  5.                   Portions Copyright (C) 1991, W.H. Bond
  6.  
  7.  
  8. This started out as a quick & dirty program for my own use.  After playing
  9. with it a little and with some prodding (ouch :-)) by Don Dawson of
  10. 1:141/730, we thought it was too fun not to pass along.
  11.  
  12. This program is based on a Byte Magazine article (March 1991)
  13. _Undocumented_DOS_ by Andrew Schulman, the article was adapted from the
  14. book of the same name, by Andrew Schulman, Raymond J. Michels, Jim Kyle,
  15. Tim Paterson, David Maxey, and Ralf Brown.
  16.  
  17. Written using DVGLUE by Ralf Brown & Ralf Brown's INTER191.Zip.  Thanks
  18. Ralf.
  19.  
  20. This program is provided free of charge for non-commercial use.  There is
  21. no warranty expressed or implied.  The user of this program assumes all
  22. responsibility for the operation of, and any consequences of using, this
  23. program.
  24.  
  25. Files displays a table of currently open files.  It will loop continuously
  26. until the ESC is key pressed.  It will only run under Desqview and DOS 3.1
  27. or higher (I've only tested it with DV 2.31 and MS-DOS 3.3 with Share.exe
  28. loaded).
  29.  
  30.  
  31. Fields displayed:
  32. y/n            sleep mode on (+) or off (-)
  33. Filename Ext   name/ext of file
  34. Size           current file size
  35. Offset         current offset into file
  36. Attr           files' attribute
  37. Mode           open mode
  38. Date           files' date
  39. Time           files' time
  40. Hnd            # of file handles referring to this file(?)
  41. PSP            File owners PSP
  42.  
  43.  
  44. Active Keys:
  45. Esc       Exit/Quit
  46. PgUp/PgDn Moves between display screens (if more than one)
  47. Home      clear and redraw screen
  48. F1        Open help window
  49. F2        Toggle open/all mode
  50. F3        Toggle regular/open mode display
  51. F4        Toggle sleep/nosleep mode
  52. F5        Toggle full path display/regular display
  53. F6        Toggle showing of detail on closed files if 'all' mode      
  54.           is selected (by using F2)
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. F1 will open a small help window, press Esc to close it.  The DVP file
  71. enclosed provides 2k of system memory needed to pop up the help screen.
  72.  
  73. F2 or the space bar will toggle open/all modes.  The initial mode shows
  74. only open files.  The all mode will dump the whole file table, files that
  75. are not open will show a 0 in the 'handles' column.
  76.  
  77. F3 will provide more detail about the open files, sharing modes and file
  78. attributes.
  79.  
  80. F4 toggles sleep mode on and off.  When sleep mode is on the program will
  81. give up one second of time after each screen refresh, this is the default.
  82. This allows Files to use very little overhead.  While sleep mode is on a
  83. '+' will be displayed in the upper left hand corner of the screen.  When
  84. sleep mode is toggled off the screen redraw will be more frequent, at the
  85. expense of hogging more system time.  The '+' will change to a '-' when
  86. sleep mode is toggled off.
  87.  
  88. F5 toggles display of the full path to the open files if share.exe is
  89. loaded and the file is found in the Dos sharing table.
  90.  
  91. F6 toggles display of closed file info if the all mode (F2).  This enables
  92. you to view the entire files table but suppresses display of info for
  93. unused or closed entries.  It may be easier to use this mode if many files
  94. are opened and closed quickly, since the positions of the open files won't
  95. jump around on the screen.
  96.  
  97.  
  98. Files attempts to be smart about the screen length and displays only as
  99. many files as will fit on the screen.  If you resize the window it will try
  100. to adjust to the new window height.  Pressing the Home key will allow you
  101. to reset the display manually if it becomes confused.
  102.  
  103. The DVP file included provides Files with 18k of memory.  If Files doesn't
  104. run properly on your system then adding a small amount of memory may help.
  105. The DVP also provides 2k of system memory for the help screen.
  106.  
  107. Questions/Comments/Bug Reports may be sent to Bill Bond
  108. 1:325/118@fidonet
  109.  
  110.  
  111. Revision history:
  112.  
  113. files005  6/25/91   Added full path display (F5).
  114.  
  115. files006  9/10/91   Added help window (F1).  Fixed problem with       
  116.                     FCB display occasionally causing window to        
  117.                     scroll.
  118.  
  119. files007  9/27/91   Added F6 key option.  Added version number to     
  120.                     help screen.  Fixed FCB display under Dos         
  121.                     v5.0.  It appears that Dos 5.0 doesn't zero       
  122.                     out the FCB table, so garbage would be            
  123.                     displayed for unused FCB entries.
  124.  
  125. files008  10/2/91   Fixed a couple of minor nits in the FCB display code.
  126.                     It was still displaying garbage in certain        
  127.                     circumstances.
  128.  
  129.